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ff you need more information about the UNZIP program 
which is used by our BOOT program to unpack the files, we 
suggest that you visit Dilwyn Jones’ web site where you find 
more information about lots of interesting QDOS software 
and INFOZIP at htfp:/www.dilwyo.uk6.net/arch/index.himl 


Ealitortall 


We were well into the production of this issue when we received news of one of the most 
significant QL developments in recent years. If we had received it earlier it would have been 
our lead news story Wolfgang Lenerz has announced a change to the SMSQ/E licence to give 
developers greater freedom to use, modify and distribute the source code. 


loy Geofit Wicks 


The SMSQ/E licence is 10 years old and has been a source of much controversy in the QL 
community, particularly in the early years. Although SMSQ/E was a great improvement on 
QDOS, some QL-ers claimed the restrictive nature of the licence hindered QL development, 
because it was impossible to port code to and from other computer systems. 


These restrictions have now been removed and it will be interesting to see what, if any, impact 
it has on the nature and range of QL software. 


Last issue | looked at the difference between QL and Spectrum users and, in particular, how 
we have continued to develop the QL. The SMSOQ/E licence change should enable us to 
continue this development. 


Although we can be jealous of Spectrum enthusiasts for their greater numbers, there are ad- 
vantages in being small. There is a long QL history of individuals transforming the QL scene. 
We are all aware of the contributions ot QL-ers like Marcel Kilgus and Nasta, but there are 
many others as well. 


What is universally regarded as the best QL website ever is the initiative of one person. | doubt 
if anyone has managed to browse the complete content of Dilwyn Jones’ website, in itself is a 
tribute to the vast amount of work of numerous individual QL-ers. 


Another project, the preservation of QL games, is also the initiative of one person. That initia- 
tive has led, with more than a little help from Quanta, to keyboard membranes still being avai- 
lable to native hardware users. It has also led to a successful commercial website. 


Most of these individuals are not remote, anonymous people. Quite often we have met them at 
shows; heard them give a presentation; read their contributions to forums; seen their articles in 
QL publications. It is an advantage of being small in numbers. 


The UK has always had the largest QL community, although its influence has waned in recent 
years as major QL developments have moved onto the continent. However, the UK can stil 
boast of being the centre for QL information. 


The danger of being the land with the largest QL community is that any decline in numbers can 
be highly visible and can sap morale. Instead we should be looking at current activity — and 
there is still plenty — and adapt to being smaller. Why, for example, do we still think of running 
shows in large halls with lots of tables? And what is wrong with a Quanta subgroup with only 
three or four members? It is not the numbers that count, but the activities that are taking place. 


One of the great strengths of the QL is that it can cater well for minority interests. Over the 
years | have always been amazed by the versatility of QL activity, and the ease of QL pro- 
gramming has encouraged this versatility. 


Let us not be frightened of being a small cornmunity, but look instead at the strengths that it 
can and has given us. 


News 


QUANTA’S Web Reversal 


Quanta has abandoned plans for an ambitious 
website containing a closed members’ area in 
favour of a simpler information site. Ina message 
on the QL-users email group the webmaster 
reported: 

“he new site will be mainly static so the 
committee will not be making much effort in 
updating.” 


USERS AND TINKERERS ASSOCIATION] 


Quanta has had plans for a website with a 
closed members’ area together with a members’ 
forum for almost 10 years, but has never been 
able to implement them. The latest efforts began 
in 2009 when Quanta appointed two webmasters 
to take on the task. They soon reported that the 
workload would be too excessive unless work 
on the site was shared by the whole committee. 
A solution was sought in a Content Management 
System (CMS), but this soon ran into technical 
difficulties. The webmasters then recommended 
that the Quanta website, then hosted by a free 
host, would have to be moved to a paid host 
who would have the technical facilities to 
support the CMS. The new host made the 
Quanta website one of the most expensive QL 
sites to run. In 2011, a year in which Quanta had a 
£760 deficit, the site cost £346. 

In a report to the 2011 Quanta AGM the 
webmasters justified this expenditure by being 
able to place a members’ forum, a Google map 
plug in for Quanta events and subgroups, a 
volunteering module, a mailing list module and 
interactive photo galleries on the website. 

A year later the webmasters reported: 

“The website has been pretty static for the last 
12 months with very little activity.” 

No reason for this was given, but in practice only 
one member of the committee, other than the 
webmasters, was prepared to use the CMS. 
Eighteen months after the move to a paid host 
the only activity on the site was a regularly 
updated news section, but other content became 
increasingly out of date. 


At a meeting held in mid October, the committee 
decided to revert to a largely static website using 
a cheaper host, although the precise meaning of 
this is not known. Since mid October the Quanta 
website has been offline on several occasions. 


Microvitec Monitor Service 


Manual 

Dilwyn Jones reports: 

“Thanks to Norman Dunbar, | have now been able 
to add a copy of the Microvitec Service Manual 
for their series-3 colour monitors to the replace- 
ment manuals page on my website. 

The document is a PDF file, 83 pages long and 
about three quarters of a megabyte to download 
from: 

hitp://www.dilwyn.me.uk/docs/manuals/index.html 

On that page go down to the Monitor Manuals 
section (about halfway down the page) and you'll 
find the link just under that for the replacement 
Cub monitor manual.” 


JUST WORDS! Dictionary Page 


Just Words! has redesigned the dictionaries 
page on its website. It is now possible to down- 
load the files either as dedicated QTYP dictiona- 
ries or as text lists. 

Geoff Wicks reports that the number of hits he 
receives on the page is larger than he would 
expect, and thought that there may be people 
looking for plain text lists. 
wanw.gwicks.net/justwords.html 
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Second Birthday 

At the end of November the QL Forum was 
celebrating its second anniversary. At the end of 
the first year they had 99 members and the 
growth has continued in 2011. At the beginning of 
November there were 146 members with 2,853 
posts on 420 different topics. 


In the last issue Jochen Merz asked a question 
about people who were formerly active on the 
QL scene and what they were now doing. 


Someone asked a similar question about Nasta 
on the QL Forum and received a reply direct from 
the horse's mouth. 

“After moving back to Croatia from the US in 
2003 (has it been so many years already?!) | 
worked for a while as a freelance designer for 
various small companies, and in early 2005 
accepted a job as a full fime hardware 
designe/developer at a small company here in 
Croatia. Due to a rather complex combination of 
job and private situations (which could be used 
to write a book or two if only one could make 
them sound less bizarre and more believable), 
my involvement with the QL and Citroen scenes 
waned. to almost nothing. One big problem that 
developed was that even though | could 
normally receive and read messages on the QL 
mailing list, | would not answer - or rather | 
could, but the answers, it seems, go to little bit 
heaven. At the moment the QL list server 
blocks all ISPs available to me, probably 
because something en-route blocks a bunch of 
IP addresses. It's rather odd to see one’s name 
mentioned once in a while and questions asked 
to which you know the answer, but also being 
unable to reply” 

He added that he had changed jobs: 

"As much as | would like to say this change 
could somehow get me back as an active 
member in the QL community, | fear | can offer 
no such guarantee, as the genre of electronics 
design | am involved with now is quite different. 
Still the QL is an ‘old love’ of sorts and even 
though the little gray cells are not what they 
used fo be :) there is a lot of information 
about the QL and it's developments still floating 
around in there between my ears, and {| will be 
glad to share it as much as available time lets 
me. Even though my arguably most ambitious 
project (GoldFire) never materialized, a LOT of 
thoughi has gone into that design and a lot of it 
is stl applicable today, so if anyone is interes- 
ted, feel free to ask- 

www.qlforum.co.uk 


QL Today Postage Shock 

QL Today is to experience a double whammy in 
the New Year. Not only are Deutsche Post raising 
their postal rates, but are also rearranging their 
product types. Among other things the cheap 


letter rate for bulk postings that QL Today uses 
will be abolished. QL Today estimates its postal 
bill will increase by almost two and a half times. 


SMSQ/E LICENCE Changed 


At the end of November Wolfgang Lenerz made 
a surprise announcement about changes to the 
SMSQ/E licence: 

“From the SMSQE licence, we will move towards 

a (new) BSD style licence, which essentially 

means that anyone can do with the source 

code anything he likes, and also distribute the 
compiled code” 

The move was greeted with great enthusiasm 

from several QL-users including some who had 

requested the change for some time. However 

Dave Park urged a degree of caution: 

‘This is good news, but let's wait until we see 

this 'fnew) BSD-like license’ - since it’s ‘(new)’ 

and may not conform to our varied expecta- 
tions of a standard BSD-like license” 

For example, will porting to other architectures 

be allowed? Will distribution as a firmware 

image be allowed? Will fees have to be paid?" 

In reply Wolfgang wrote: 

‘Redistribution and use in source and _ binary 

forms, with or without modification, are permitted 

provided that the following conditions are met: 

* Redistributions of source code must retain 
the copyright notice, this list of conditions 
and the following disclaimer. 

* Redistributions in binary form must repro- 
duce the copyright notice, this list of condi- 
tions and the following disclaimer in the 
documentation and/or other materials provi- 
ded with the distribution. 

THIS SOFTWARE IS PROVIDED BY THE COPY- 

RIGHT HOLDERS AND CONTRIBUTORS ‘AS [S' 

AND ANY EXPRESS OR IMPLIED WARRAN- 

TIES, INCLUDING, BUT NOT LIMITED TO, THE 

IMPLIED WARRANTIES OF MERCHANTABILITY 

AND FITNESS FOR A PARTICULAR PURPOSE 

ARE DISCLAIMED, IN NO EVENT SHALL 

COPYRIGHT HOLDERS BE LIABLE FOR ANY 

DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEM- 

PLAR¥Y OR CONSEQUENTIAL DAMAGES 

(INCLUDING, BUT NOT LIMITED TO, PROCURE- 

MENT OF SUBSTITUTE GOODS OR SERVICES; 

LOSS OF USE, DATA, OR PROFITS; OR BUSI- 

NESS INTERRUPTION) HOWEVER CAUSED 


AND ON ANY THEORY OF LIABILITY WHE- 
THER IN CONTRACT STRICT LIABILITY OR 
TORT (INCLUDING NEGLIGENCE OR OTHER- 
WISE) ARISING IN ANY WAY OUT OF THE USE 
OF THIS SOFTWARE, EVEN IF ADVISED OF 
THE POSSIBILITY OF SUCH DAMAGE” 


The Copyright Holders are the two main archi- 
tects of SMSQ/E, Tony Tebby and Marcel Kilgus, 
and 10 others who have contributed to its 
continued development. 


DILWYN JONES’ Programs 


Dilwyn Jones has announced a number of 
additions to his website: 

“A free game and mandelbrot graphics tool have 
been added to my website this week, along with 
an update to PCB Design and copies of the 
Italian versions of the Psion programs for the QL. 
The game is Rockfall, a colourful Boulderdash 
clone from the late 1980s. Originally published by 
CGH Services, the author Andy Toone gave Rich 
Mellor his blessing to release it freely. It's avai- 
lable to download as a conventional zip file plus, 
thanks to Rich, a zipped version specially for use 
in QemuLator. After downloading the QemuLator 
version, just attach it to one of QemuLator's drive 
slots and run the game straight from the archive. 


Port Converter 


As you may have seen, a developer in Italy has 
developed a converter to convert a PS2 mouse 
to work either of the games ports on a Black 
Box QL. 


This has all sorts of possibilities but also limita- 
tions. Those of you with ICE software can use 
this interface. As far as | know this software is no 
longer sold and is not in the public domain. 
Maybe someone can rescue it and put into the 
public domain. Also, unless someone has the 
skills fo change it, this interface will not work with 
PRT_GEN and WMAN which means. standard 
PTR programs will not work. This converter is not 
a replacement for the QIMI interface, but you can 
write your own SuperBasic applications, with or 
without SMSQ, because you can use such func- 
tions as KEYROW to read the mouse. Then there 
is no need to load PRT_GEN and WMAN exten- 
sions. 


So how does it work? The converter translates 
the movements of a serial mouse to up, down, 
left and right keys as used on the games ports 
of a the QL. It also provides one button (fire) 
using either of the mouse buttons on a standard 
{wo button mouse. The converter is based on a 


Review of PS2 Mouse to Games 


Rockfall is available to download from my games 
page at 
http://www.dilwyn.me.uk/games/index.html 


The Mandelbrot program is called Mandel-Speed, 
from the same author The program is available to 
download in the two versions described above 
from the graphics page on my website al 
hitp:/Avww.dilwyn.me.uk/graphics/index.html 


And thanks to a QL user in Italy, | have also been 
able to make available {talian versions of Quill, 
Archive, Abacus and Easel, version 2.23 from 
http://wwrw.dilwyn.me.uk/psions/index.html 


And finally, the latest version of Malcolm Lear's 
PCB Design package, version 7.25, is available to 
download from the graphics page at 


http://wwaw.dilwyn.me.uk/graphics/index.html : 


by Dan Burkinsineny 


Microchip PICi6F84A microcontroller The PIC 
deals with the serial data stream from the mouse 
and converts this into the games keys. These 
keys are represented by what are called by 
bilateral switches (CMOS IC 4066 or 4016), which 
is an electronic switch with a control input. High is 
closed, low is open. So why do we need to do 
this? Because the QL uses a scanning keyboard. 
Why scanning keyboards? Having two wires for 
each key on a keyboard is not very efficient way 
of working. So the wiring can be simplified by 
arranging the wiring into row and columns as 
shown at the top of the opposite page (figure 1). 
This is in fact the QL keyboard layout. 


At each crossing of a row and column there is a 
switch, 
which is a 
key of the 
keyboard. 
As shown 
here in fir 

gure 2: 


Column 


Row r 


Figure 2 


Figure 1 - QL Keyboard Matrix 
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As you can see there are 65 keys on a QL 
keyboard, which would need at least 66 wires, 
one for each key plus say ground, however by 
using the scanning keyboard with row and 
columns only 20 wires are required. 


So how does this work ? The columns are fed 
with a pulse, sequentially, only one column is 
pulsed at a time. As a key/switch is closed that 


Control 


In/Output 


Figure 3 


In/Output 


Each CMOS 
Switch is % 
4016 device 


pulse is sent to a row. So with a given pulse to a 
column and the key/switch closed to a given row 
selects the key required. 


Thus what is needed is to replicate the keys/ 
switches with electronics switches. This can be 
done by using, CD4016 (or 4066) quad bi-lateral 
switch integrated circuit. A representation of this 
device is shown below in figure 3. 


Two 4016's (or 4066) are 
used, since each 4016 (or 
4066) contains four switches. 
We use one IC for right, left. 
up and down. The second IC 
just uses one switch for the 
fire button. 


There are two game ports 
on the QL. One is called 
CTL1 and the other CTL2. 
The keys are represented as 
follows (table 1 on the next 


page): 


= 
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CTL1 
Up Cursor Up 
Down Cursor Down 
Left Cursor Left 
Right Cursor Right 
Fire Space 


Table 1 - QL game ports 


If you look at the keyboard diagram on the previous page, you will see that row 8 is common for CTL 
1 and row 1 is common for CTL2 so only the columns need to be selected. 


Back to reviewing the interface now | have explained how it works. 


So to start with, you need to down load the zip file 
http://www.qlforum.co.uk/viewtopic.php?f-28&t-379 


from the QLForum page. When you open this zip file you get the following files: 


GC_QLMouse - Assy.pdf 
GC_QLMouse - Components side.pdf 
GC_QLMouse - Firmware.[HEX 
GC_QLMouse ~ Lead..pdf 
GC_QLMouse - Parts List.pdf 
GC_QLMouse - PCB.pdf 


Component placement PCB looking from component side. 
As above without PCB tracks 

PIC Firmware 

Shows wiring from the telco connector to 9 pin d-type. 
As it says Parts List 

Again as it says the PCB track diagram 


There is enough information here to manufacture the interface. However you may not want to go to 


the expense of the 
PCB (printed circuit 
board). It is true 
the PCB makes a 
neater job, but un- 
less you have ex- 
perience and the 
equipment, it is not 
always the easiest 
to do. However not 
all is lost since the 
circuit is not too 
complicated. | 
produced mine on 
a piece of strip 
board. | have not 
reproduced the cir- 
cuit here since it 
available from the 
above zip file. 


added LED's with limiting resistors to the switch 
(IC 4066) control inputs, just to show me that the 
converter was working correctly. You do not 
need to add these if you don't want to. If you 
ook at the Italian pictures on the blog page you 
will see the developer obtained power via the 
ROM port. This is OK if you have a spare ROM 
card. | did not, so | used a 78L05 voltage regula- 
or as shown in the original schematic to provide 
he 5V required from a 9V battery source. You 
can make whatever power arrangements you 
ike, the converter just needs 5V. The interface 


takes about 15mA, (without the LED's. so with a 
R22 (PP3) battery it will run the interface for hours. 
| used rechargeable balteries with no problem. 


You will need some way to program the PIC. 
There are low cost PIC programmers around, 
either on the web or available as kits, from sour- 
ces such as Maplin’s. Of course this adds to the 
overall cost of the project. | will be looking into 
this further in the next article of my series on the 
12C interface. Since my next project also includes 
a PIC, so this may help to spread the cost of the 


PIC programmer. If you are interested in these 
projects and you cannot wait, the Vellaman PIC 
programmer K8048 will support both this project 
and my next I2C project. It is available from Maplin 
as a kit. Whatever you do, do make sure the pro- 
grammer you use supports, in this case, the 
PICI6F84A chip. Not all do. 


Now the mice themselves. You will see from the 
PCB layout and the circuit diagram that the 
developers have used a USB connector There 
are USB mice, which support the PS2 serial inter- 
face. However most USB mice do NOT support 
PS2. In fact, | could not find a USB mouse with 
PS2 from any of the major UK suppliers. That is 
not to-say there are none out there, but | just 
could not find one. However all is not lost. | am 


5 Pin Standard DIN Socket (Female) 


PIC Pin 18 
DATA 
*SVDC— SNE 
03) ye\— PIC Pin 17 


Clock 


The BT telephone style connectors are a pro- 
blem. | have looked around and they don't seem 
to be available anywhere. | checked with Adrian 
Ives of Memory Lane Computing and SerUSB 
fame, since he was the last person to sell any 
add on that used this connector He confirmed 
they are no longer manufactured. He purchased 
the last from an on-line source, and even these 
have now gone. Unless, of course, anybody, 
knows different. There are two types of this 
connector used on the QL. 603A Right Hand 
BICC BT type for the RS232 serial ports and 
603A Left Hand BICC BT type for the games 
ports. The plugs for these are called 631W. Cur- 
rent standard BT (631A) connectors may look the 
same, but in detail they are different and just do 
not fit. So on my Black Box QL's | have fitted 9 
pin D- Types on a flying leads, and soldered fo the 
underside of the QL PCB. So in effect | have 
made my QL's as if they were the US version, 
which were [ilted with D-Type connectors. This 
does require the QL to be opened up, so great 
care is required. If you are not sure 100%, don't do 


Looking from rear of sockets 


sure most have mice with either a 5 pin DIN or 6 
pin Mini DIN connector lying around somewhere. 
You might find them at car boot or surplus sales . 
The connections for these types of mice are 
shown below. You will also find mice with 9 pin 
D-Type connectors which state they are serial. 
They can be, but not to the PS2 standard. They 
use an RS$232 serial protocol at 1200 baud. There 
was software to do this from Albin Hessler, (my 
copy is dated 1992) called SER Mouse for use 
with these types of mice. Again as far as | know 
this is not in the public domain. Note: the Qimi 
mouse interface used a 9 pin D-Type connector 
as well, but the Qimi interface does not support 
serial mice, but used mice that were directly 
connected to the opto devices and switches in- 
side the mice. This can get a little confusing. 


6 Pin Mini DIN Socket (Female) 


PIC Pin 18 
Clock 


Pn 
~ PIC Pin 17 
DATA 


it | take no responsibility if it goes wrong. So 
why did Sinclair not do this on the UK versions — 
simple, cost. 


The cost of this project, should be no more than 
£15 (without the LED's) to build. 


Conclusion, does this interface work? The simple 
answer is that it does. | built mine up on strip- 
board in about an hour or so, programmed the 
PIC and it worked first time without problems. 
The mouse response was very good, no confu- 
sion as to direction at all. There are limitations 
compared with say the SER Mouse software 
solution or QIMI hardware interface. For example 
this interface only supports one mouse button 
(fire). Other than some games that used the 
games ports and the ICE software, there is not 
much ready to run software around that will work 
with this interface. It could be of use for none 
PTR developments. Of course for games players, 
you could build two interfaces with two mice, one 
for each (CTL) games port on your QL. Now you 


The timing was foriuitous. Last summer | was 
testing a JPG to PIC transfer program that | hope 
eventually to post on the Just Words! website. It 
has been through a number of versions as | 
passed on suggestions fo the author to improve 
its ease of use and versatility. | needed a simple 
PIC viewer and almost on cue Bob Spelten deli- 
vered the goods with a new program SQRview. 


One of the problems with JPG images is that 
they are usually taken with a digital camera and 
are a giant size. My camera produces images of 
about 4Mb. Even a much reduced image would 
test a PIC viewing program to the limits, but 
SQRview coped well. For the purpose of this 
review | converted the JPG images to BMP which 
SQRview recognises, and reduced their size to 
simplify matters at both the PC and QL ends. 


Loading is easy. When you start the program 
there is a simple menu (Fig. 1) and clicking on 
load brings up the menu extensions to help you 
locate the image. You are asked a question on 


by Geottt Wicks 


whether you want to load as a PIC or a sprite. If 
your image is smaller than the SQRview default 
screen then it fits within this window (Fig. 2). If it 
is larger than the default screen then the window 
automatically adjusts to the size of the image. To 
illustrate this | have deliberately chosen an image 
with unusual proportions (Fig. 3). 


My digital camera takes images of 3872 x 2592 
pixels and provided | had sufficient memory on 
my machine SQRview would still have loaded 
them, but then with vertical and horizontal 
scrolling bars. 


A right click (DO) on the image produces a pop 
up box giving the properties of the image and 
giving the option to save or quit. 


In his manual Bob Spelten describes the 
genesis of the program: 


“SOQRview started life as a test program after a 
discussion on the QL-users list in June 2009 
on ‘how to make a scrollable menu for QL 
screens with EasyPTR’. Then it got a bit out 
of hand’ 


It is a situation that many QL hardware and soft- 
ware developers will recognise. lt is this 
constant eagerness to explore and accept new 
challenges that has made the QL what it is 
today. 


We should be very grateful that it did get out of 
hand as Bob Spelten has produced a powerful 
tool for programmers who are eager to use 
sprites. | have to confess that | have not explored 
this aspect of the program in any great detail, 
because my main interest was in using it as a 
quick viewer. 


If you want to convert an image to a sprite you 
have a number of options to choose. First you 
can choose between mode 64 and mode 16 
sprites. Figures 4 and 5 show the quality diffe- 
rence. You then have various transparency op- 
tions. 


The more you look into this program, the more 
complicated it becomes, because the oplions 
you are given af any one time can vary 
according to the size of a file, its format and 
how you want {fo save it. Recognised file 
formats include the QLs PIC, PSA. SCR, SPR 
and PCs BMP and ICO. There are also 


you only need to master those parts of 
the program needed for your QL 
system and way of working. 


To run SQRview you have to have a 
system capable of displaying GD2 
colours, but it can handle numerous 
different QL modes. You may also need 
a large amount of memory because in 
general graphics are memory hungry. 


In summary it is impossible to describe 
the details of the program in a few 
hundred words. The best advice is to 
give it a try You can download the 
program from Bob Spelten's website: 
http:/members.upc.nl/b.spelten/ql/ 


And let us hope that many more things 
will get out of hand, not only by Bob Spelten, but 
also many more developers. 


numerous configuration options. Do not be put off 
by this apparent complexity as there is a 
comprehensive and easy to follow manual. Also 


SQRVIEWS DOS7_Gull .bep SQRVIEW 00S7_Gull bap 2 7 _ fOD 


The continuing saga of George 


Norman by George Guvillt and 


Norman's INDI answers to George's [GG] comments on Assembler ~ Part 32. Comments inserted by 
the Editor are marked [ED]. 


{GG] Part 2 of Norman's articles on LibGen — Library Generator is rather tantalising in that after you 
have typed in all the code you get eight errors, as promised, when you try to assemble il. This of 
course is due to the missing routines required to inpul and process the files and comments on these 
will obviously have to wait. 


{NDI Yes, I'm afraid that's very true. The arlicle | submitted for publication did actually have the 
missing routines, unfortunately, Jochen contacted me to ask if he could split the article as he had run 
out of space. You may notice that the end of the article was on the inside back cover! 


Anyway. | advised on a half decent place to split it which was right after the comment about getting 
assembly errors at this stage. There were a few more pages of code and editorial to follow, but these 
will be in the next issue, | hope. 


{ED] Our apologies to Norman for having to split his article. It was only at the laying out stage that 
we discovered the article was longer than expected and by then we had run out of space. 


[GG] Nevertheless I do have a few remarks to make on the program so far. 


1. The code on page 45 which clears the status area and sets four loose items to unavailable could be 
shortened to: 


lea wst0,al Unchanged 
3 movea.1 al,a0 Deleted 
moveq #ustO_e-wst0-1,d1 Unchanged 
st_clr clr.b (al,d1.w) Altered 
~ dbf di,st_clr Unchanged 
;st_loose lea ws_litem+1i_libfile(al),a0 Deleted 
moveq #3,d1 Unchanged 


st_unav move.b #usi_unav,ws_litem+li_libfile(ai,d1.w) Altered 
dbf di,st_unav Unchanged 


This code has two advantages over the original: it does not use AO and there are fewer instructions. 
The fact that the original code, at least the first few instructions, were mine shows that any implied 
criticism should be directed to me not Norman. 


{NDI Ah well, at least it's not all my fault this time. --) However, this does indeed save an address 
register, which might be necessary in some applications. 


[GG] 2. At the foot of page 49 the instruction finding whether ESC was typed is: 
shese cmpi.w #27,01 


| diffidently suggest that “cmpib’ might be better This is because in reading a string with a terminator 
such as ESC you have to process one byte at a time. Even if DLB is #27 there may be no guarantee 
that DIW is. 


INDI Hmm, | thought George had found a bug, but | checked my own code in iw_input and it sets 
DIiW to 27 if the ESC key is pressed to terminate the edit, so the CPMIW is correct. 

Equally, | checked the docs for the underlying WMENAME vector. and it too states that the returned 
terminating keypress value is in DiW and not DiB. 

My own code sets DO and DiW correctly according to the docs which WMAN doesn't actually do. | 
know this as | had problems in this very utility because of pressing ESC and | traced the execution. My 
forthcoming code has the following in it: 


jsr wm_ename(a2) Edit string in info window. 
blt.s iw_exit Negative is an error. 


? 

; Bug alert. It seems at present, that this vector always returns with 
; DO set to zero or negative, but never positive. Sigh. The following 
3 code tries to reset that situation to how it should be, according to 
3 the docs. 


i] 


empi.w #27,d1. ESC pressed = abort edit. 
beq.s iw_ese Yes, all done. 


12. (i 
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empi.w #$0a,d1 Was ENTER pressed to end the edit? 


bne.s iw_ese No, set DO positive. 
elr.1 dO Zero = ENTER was pressed. 
bra.s iw_exit Done. 
iw_esc moveg #1,a0 Set DO positive as required. 
iw_exit eas 
tst.1 dd Make sure Z is set correctly. 
rts 


So, my library routine iw_input returns DIW and DO correctly according to the docs for 
WM.ENAME/WN.RNAME which is more than can be said for WMAN! 


[GG] 3. The code at “sh_ok” on page 50 starts by saving the WMAN vector on the stack. There is 
actually no need for this since the vector has been stored at wmvec(a6) shortly after ‘start’. When the 
vector has to be restored you can use: 

movea.1 wmvec(a6),a2 


IND] This is correct. | had forgotten that the WMAN vector was saved in the job's data area right 
back at the start. 


[GG] | am always slightly nervous when | put something on the stack since | have to remember to 
Clear the stack at every exit from the code. Using wmvec(a6) instead would make me that much more 
confident. 


IND] This is true, | do a similar thing myself from time to time. It's sometimes a lot easier on the old 
brain cells to stuff a much wanted value into the data area rather than trying to (a) remember to save it 
on the stack when the register is needed elsewhere and (b) restore it afterwards. Just use the register 
and get it from the data area when needed again. 

| sometimes find that some of my code loads the desired value into the desired register when it is 
already there, but no harm done, other than wasting a few clock cycles. 


[GG] 4. Finally | couldn't resist using my own versions of the missing routines and | can confirm that 
the file names are indeed printed as described by Norman. 


[NDI | know! I've tested it! It's coming along nicely | think! It's quite disconcerting to see exactly how 
much extra hard work goes in to writing a utility in assembler compared to the code required to do 
the same in SuperBasic. | have a reasonably short utility - my proof of concept — written in 
SuperBasic and EasyMenu. Took me a couple of hours to cobble together and test. Assembly takes 
much much longer. 


[ED] The discussion continued a few days later: 


[GG] On exit from WMENAME and WMRNAME the condition codes are set negative for an error 
(because DO is so set), zero for NL (ENTER) and posilive non-zero for UPDOWN and ESC. If there is 
no error DO can probably be anything. The non negative condition codes are set because of the value 
in Di. Your WIKI is correct in its description of the vectors. Interestingly it does not say what the value 
of DO is on exit! 


INDI Actually | checked the docs. Every “error return’ section is what we get back in DO. The error 
return for wm.rname/w,ename states that this will be +ve if the terminating character is not ENTER. 


{GG] The manual is ambiguous. When it says “Any I/O sub system errors’ it implies that if there is an 
error DO will contain its value (negative) and that the condition codes will be so set, as is normally the 


case. It then appends the line »0 if terminating character not Nb” This only applies to the condition 
codes (but how can you tell). 


[ND] The text mentions that the condition codes will be -ve (error), zero (Enter) or tve (ESC, UP 
DOWN), not DO. The table of registers gives (me) the impression it's the error return in DO that is -ve, 0 
or +ve. 


{GGI | looked at the source code and found that DO is set if there is an error, and the condition codes 
are set accordingly. If there is not an error the value in DO is whatever it was sometime back in the 
program. | didn’t check what this might be, but it could be anything. When there is not an error the 
terminating character is set in Di and compared with $0A thus setting the condition codes which, in 


that case, can't be negative. 


| have an endless thirst for ail things computer 
gaming, but the games that often fascinate me 
ihe most are the ones that get away, the games 
that time forgot. The obscure games where you 
read a little snippet or see a screen shot in an 
old QL Magazine. Just how many copies did it 
sell? Does someone have a copy quietly 
sleeping in a drawer or in a box up the loft? Or 
sadly have they all been binned and cease to 
exist? How did it play? What was the box like? 
Did it even get released in the first place? 


| always like to imagine that even the rarest of 
games is out there somewhere waiting to be 
rediscovered. | recently got very lucky in tracking 
down a copy of Fleet Tactical Command but Im 
still panicking about how to make a backup copy 
that keeps the games copy protection intact. 
Anyway, the following is a very shaky and 
certainly not complete feature on some games 
as mentioned in old magazines, fanzines or the 
rwap ql_Wiki that I'd love to know more about. 


THE HEART OF GERN from PCBS 


was to be the first game in a series of graphical 
adventures set in the fantasy world of Prince- 
lands. The lone adventurer Tirac seeks fo find a 
black jewel which imprisons an evil spirit. Said 
evil spirit is also sought by an evil cult as part of 
a master plan hence the plot is a race against 
time. The game was advertised (QL World May 
‘87) on microdrive and disc but also for modes 4 
or 8. Also mentioned is a sequel called THE FATE 
OF THE ORACLE, did the sequel see the light of 
day? 


GUMSHOE LOGIC by Megacycal 
Software Ltd in 1985 is a strange sounding 
prospect of a game. Part text adventure and part 


The Games ttiat Time fro 


ROU 
aa 


puzzle game which sees you running a Detective 
Agency. Money can be spent on informers to 
help solve the case. It conjures up images of a 
hard smoking/drinking Sam Spade but | have no 
idea if that is close to the mark or not. 


AMBITION from WAY AHEAD was adver- 
tised (QL World August ‘88) as a business orien- 
ted strategy game. Possibly sounds like some 
kind of board or puzzle game maybe a computer 
version of monopoly. The QL had quite a few 
business games, Financial Climes and Tycoon are 
other examples of the genre. 


THE SIMULATOR by Ekotek of Holland 
sounds like it was the most advanced of all the 
QL Flight Sims. One happy reader writing in fo QL 
World ‘89 Sept had enjoyed flying under bridges, 
across lakes and round mountains. The game 
consisted of two worlds one in colour and one in 
monochrome plus an add-on pack was available 
with more worlds for £10 


And finally two relatively unknown football games 
TOP TEAM by Arunsoft sounds like an ac- 
complished football manager game featuring 
tactical selections, scouting reports and even 
real time text game commentary. The more un- 
usual sounding HERE WE GO from impact 
Entertainments was a text adventure written in 
using ACT (Adventure Creation Tool) that saw you 
tasked with getting to Wembley on cup final day. 


Hopefully someone can remember these games 
or even better have a copy nestled away that 
would be something special. The RWAP QL Wiki 
has a list of games that are missing in action and 


its sad to think of these enticing games {and 
many others} that could be lost. Could the QL 
scene benefit in following the Spectrum scene 
which has well orchestrated projects to preserve 
software for the present and future? 


[Ed.}: Peter asks for more information on these 
games, and, even as a non-games enthusiast, | 
can start the ball rolling. 


THE SIMULATOR is about the only game that ! 
have ever bought and | would agree with the 
reader who reviewed it in QL World. It was 
originally distributed on two microdrives or, later, 
on one floppy, and had copy protection allowing 
you to. make no more than five copies. In addi- 


In the news section we report on Quanta’s 
decision to scrap its plans for an active website, 
and to go over to a largely static one. It is the 
latest development in a long history of Quanta 
web failures. The tragedy is that for the last five 
years - and possibly even longer - Quanta was 
90% on the way to achieving a successful active 
website. It has never mastered the last 10% - the 
art of keeping a website up to date. | hear more 
moans from Quanta members about out of date 
websites than on any other issue. 


Quanta’s first website was set up about 10 years 
ago by the then chairman, Robin Barker Robin 
had considerable web skills and came the nearest 
to setting up a dedicated members’ area. As a 
first stage he had created a page where members 
could register their contact details. Unfortunately 
there was less awareness in those days of the 
need for firewalls and the site became a target 
for hackers and spammers. When the host 
ceased trading it had to be taken down. 


In the 8 years since Robin Barker stepped down 
as chairman Quanta has never had an officer with 
web experience or web expertise other ihan for 
one year when the present webmaster doubled 
up as Ireasurer The new officers continued to 
parrot Robin's plans for the site promising a 
closed members’ area containing among other 


What went wrong’ 


tion to the default world the add on pack al- 
lowed you to fly by night or in urban, rural, sea 
and desert worlds. It could only run on native 
hardware because, if | remember rightly, of 
system pokes. 


Eventually my native hardware became more 
ancient and erratic and {| donated my copy to 
Rich Mellor for his preservation project. | 
believe Rich managed fo get it running on one 
of the emulators but | can no longer remember 
the details. 


Is there a reader who can remember more 
about THE SIMULATOR or one of the other 
programs Peter mentions? 


As long ago as 2004, when I was on the Quanta 
committee, | asked who was responsible for the 
editorial content of the website and | never re- 
ceived a reply. | have asked the same question on 
many occasions since and usually the response 
has been a blank stare. In retrospect | think 
Quanta's officers genuinely did not understand the 
point of the question. 


In the middle of the last decade | had personal 
experience of the officers’ ignorance of the imme- 
diacy of the internet when | hosted dedicated pa- 
ges for the QL2004 and QLis21 shows on my 
website. Usually | was able to update the non- 
Quanta QL2004 page within 24 hours, but up- 
dating the Quanta QLis21 page could take up to a 
week while | waited for the officers’ approval. 


The origins of the present website go back fo 
2007 when Quanta found someone to fill the post 
of webmaster that had been vacant for two years. 
He created a relalively simple site with Home, 
Events, Magazine, Subgroups, QL Systems and 
Traders pages. There was a major innovation at 
the end of 2008 when it became possible to pay 
the Quanta subscription online via the website 
and Paypal. 


QUANTAgg 


QUANTA 


the QL Users and Tinkerers Association 


things a members’ forum. They had little under- 
standing of the practical and technical issues in- 
volved and assumed a webmaster would have 
an instant solution to any problems. In particular 
they did nol seem to understand the difference 
between a webmaster and a web editor 
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Fig. 1: Quanta’s 2007 website 


The website soon fell into disrepute for out of 
date content. The officers had no machinery for 
regular updating and what updating there was 
appeared to be on the occasional whim of the 
chairman. {| shall draw a discrete veil over one 
updating in 2008 that had to be taken down very 
quickly for legal reasons.) 


During 2009 the websife was upgraded with an 
open members’ area, mainly to allow downloading 
of programs published in the Quanta Magazine, 
but also containing a QL news section. Quanta 
again announced the intention to introduce a 
closed area where members could download 
programs from the Quania library and the latest 
copies: of the Quanta Magazine. A members’ 
forum would also be introduced. By then an extra 
member had been co-opted onto the committee 
to assist in its development. 


Quanta’s two webmasters soon concluded that 
further development of the site would not be 
possible unless the work was shared by other 
committee members. They recommended the use 
of a Content Management Sysfem (CMS). Quanta 
looked at two systems, Joomla and Typo3, and at 
a meeting held in late 2009 the committee opted 
for the latter. 


The implementation of the CMS proved to be 
more difficult than expected and for over six 
months during 2010 it proved technically impossi- 
ble to update the site. As often happens when 
Quanta is faced with a serious problem, the 
officers went into Trappist mode and withheld the 
problems from the members. The only informa- 
tion given was a cryptic message from the secre- 
tary in the Dec 2010Nan 2011 Quanta Magazine: 
“Taking about ihe website, | think we are close 
io being ready to launch on this, more 
information will be found in this issue” 


In fact there was no further information in that 
issue. 


By the last quarter of 2010 QL Today had been 
aware for some fime that the Quanta website was 
in serious technical trouble. We initially deduced it 
from the continued failure to update the news 
section and later had some confirmation from 
Quanta sources. We decided, however, not to 
publish, partly because no Quanta commiltee 
member would speak on the record and partly 
because we knew Quanla had an emergency 
committee meeting planned to altempt to solve 
the problems. 


Two months after the committee meeting there 
was still no sign of the problems being solved, 


and, after some critical comments about the 
website on the QL-users email list, we published 
the story in the Feb-Apr 2011 issue. What | did not 
publish, however, was that the web problems had 
caused serious tensions within the Quanta com- 
mittee with some angry emails in circulation. | 
formed the impression that more than one 
member of the committee were considering their 
position. 
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QUANTAS Web Collapse 

The Quanta website has been hil by serious 
technical problems that have prevented it from 
being updated for over 6 months. QL Today un- 
derstands the new Conlent Management System 
(CMS), introduced al the beginning of last year 
has suffered a massive lakwe. The cause of this 
is proving elusive. individual Quanta committee 
members are reluctant to speak on the record 
about the problems, but a number of sugges- 
tions for the faiure are being made. These in- 
clude Quanta's asprrations for the site being too 
ambilious; the jack of technical support from a 
free host; and the difficuties of inlegraling a 
Linux based CMS into a Windows environment. 


Fig. 2: QL Today's 2011 news slory 


At least one member argued for Quanta to go 
over to a simpler website, but the advice of the 
webmasters prevailed. The problem was that a 
free web host could not offer the technical sup- 
port that Quanta needed. A new website was 
launched using a paid host in the middle of 2011. 
but the new web host was very expensive. In 
2011 Quanta paid £346 for its website, more than 
seven times what | pay for the Just Words! web- 
site. 


The webmasters justified this expenditure in the 
March 2011 Quanta Magazine: 

"The WEC service includes daily backups of the 
QUANTA website and members’ area, automatic 
upgrades of Typo 3 sofiware modules, access 
to online training materials, and a user forum so 
we can share best practice with other Typo 3 
users around the world. 

WEC have developed an impressive templating 
engine, which will enable us to alter the look 
and feel of ihe QUANTA website by changing a 
few background images and style sheets. 

! am developing different templates for the 
QUANTA homepage, each of the landing pages, 
and the detailed content pages. 

Best of all, WEC have written some custom 
plug-in modules: 


e A threaded discussion forum for the 


members’ area, 
e A Google map plugin so we can show the 


location of QUANTA subgroups, workshop 
venues and events 

e A volunteering module to enable members 
to indicate their areas of interest and ability 
to help 

° A mailing list module to enable us to 
circulate a regular e-newsletter to members 

e Interactive photo galleries, so we can 
promote QUANTA events and workshops 


Additional features that will be provided: 

e Members Area, archived copies of 
magazines and source code will be 
available for members to download 

* News updated frequently, news can be 
submitted to the committee for publication 
on the websife or when the committee 
spots some important news it will be 
published 

¢ Multiple editors, additional editors can be 
brought online to edit content at any time.” 


A year later the webmasters had a different story 
fo tell: 


‘The web site has been pretty static for the last 
12 months with very little activity” 


and 


*_.hopefully you will see some changes start to 
happen soon and the members area will 
become accessible’ 


8 months after this promise was made no chan- 
ges were apparent. It was no longer a technical 
failure, but a human one. In their Quanta Magazine 
article the webmasters wrote the new web host 
would ‘free up the cemmittees’ (sic) time to 
focus on content and design, rather than 
worrying about the complexity of this powerful 
CMS", but in practice only one member of the 
committee other than the webmasters had been 
prepared to use the CMS. Not one of the 
officers had contributed to the website's content. 


At the beginning of November the website was 
describing a magazine published 18 months 
previously as ‘recent’. The shows page was stil 
publicising the Austrian show held in June and 
although Quanta has had a new constitution for 
7 months, the old one remained on the site. 


In the middie of October the Quanta committee 
held a further meeting fo discuss the website. 
In a message posted on the QL-users email 
group the webmaster reported: 


‘The committee decided that moving to a chea- 
per platform was a good idea and | have now 
been tasked with finding a service fo use (I 


know there are plenty around so will be feeding 
back my thoughts to the committee). It was also 
agreed that the new site will be mainly static so 
the committee will not be making much effort in 
updating the site (though we will use a different 
CMS system we can make updates as required).” 


Just what this means in practice is unclear, but it 
appears that Quanta has abandoned plans for a 
closed members’ area and that site will become 
purely information on how to join Quanta and on 
QL systems. 


In my opinion the closed members’ area was 
always a non-starter. It was proposed that mem- 
bers could download programs from the Quanta 
library, but these days traffic in and out of the 
library is negligible. The members could also 
download the latest Quanta Magazines, but why 
would they need to do this when they get a copy 
anyway? It is also current policy to make the 
magazine public after 2 years. 


The only purpose of a closed members’ area 
would be a members’ forum, but Quanta had 
made no detailed plans for this. The issue of 
moderation of a forum had not even been 
discussed and the time required for moderation 
had not been considered. 


In fact once you scrap the idea of a closed 
Members’ area, the present website is a good 
one provided it is kept up to date. That would not 
be an onerous task. The hardest job is keeping 
the news section up to date, but that is already 
working satisfactorily. Next would be the maga- 
zine with six updates a year and then the events 
page with no more than 2 or 3 shows a year. 


Ultimately the failure of Quanta websites has’ not 
been technical, but human. And most of the 
blame must go not on the shoulders of the 
webmasters but on the officers. The content of 
the website is not the responsibility of the 
webmasier, but that of the officers and they have 
always failed in their duty over many years to 
keep websites up to date. 
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Machin’s Formula tor Pl 


In my recent article on large integers | quoted Machin's formula for Pl as 
4¥PI = 4%atan(1/5) — atan(1/239). 
4*P1 is wrong. It should have been Pi/4. 


Happily the code showing the calculation is actually correct. But how on earth is such a simple 
expression equal to Pl/4? | give the following explanation in case others are as puzzled as | was. 


The problem is to find a more swiffly converging series than that for 
PI/4 = atan(1). 


Suppose we find a small angle A whose tangent is the reciprocal of an integer n and is nearly equal 
to Pl/(4*k} where k is an integer In that case we would have 


by George Guilt 


A=atan(1/n) [1] 
and 

PI/4 = k¥A — B where Bis a small angle. Then 

B=k¥A-PI/4 [2] 
So 

tanB= tan(kA—PI/4) [3] 
Now 

tan(x+y) = (tanx+tany) /(1-tanx)*tany) [4] 


From this we see that 

tan2x = 2tanx/(1-tanx“2) [5] 
Using 4 on 3 gives 

+anB = (tankA—1)/(tankA+1) [6] 


Repeated use of [4] and [5] will give tanB in terms of tanA. If tanA is a rational number so will tanB be. 
Thus both A and B can be found by series more rapidly converging than that for atan(1). 


Examples 
Ln=2andk=2 
tanA = 1/2 so tan2A = 1/(t-1/4) = 4/3. Thus tanB = (4/3 - 04/3 + 1) = 1/7. 
So 

PI/4 =2atan(1/2) -atan(1/7). [7] 
2.n=3andk=2 


tanA = 1/3 so tan2A = (2/3)A{L - 1/9) = 3/4. 
Thus tanB = (3/4 — 1)(3/4 + 1) = -1/7. [B is negative] 
So 

PI/4 = 2atan(1/3) +atan(1/7). [8] 
3.n=5andk=4 
tanA = 1/5 so tan2A = (2/5)A1-1/25) = 5/12. Applying [5] again we get 
tan4A = (LO/12)l - 25/144) = 120/119. 


Thus tanB = (120/119 - 1)(120/119 + 1) = 1/239, 


So 

PI/4=4atan(1/5) —atan(1/239). [9] 
4. 
Taking the average of examples 1 and 2 gives 

PI/4=atan(1/2) +atan(1/3) [10] 


[9] is Machin's formula. 


Programming in Assemoler, Part 31 
LiinGen = Library Generator - Part 3 


oy Noman (Dunlnar 
Ed: Thanks a lot for your patience - as explained in the by 


previous issue, we ran out of space, therefore we had to split this article into two parts. 


The Utilities Library 


Scroll to the end of the file and add the following lines, obviously, you will adjust the file name to suit 
your own installation. Unless, of course, your setup is exactly the same as mine. You may also note, 
that while | refer to the code as a library, it is not yet converted into one. When we complete LibGen, 
we shall use it to build a working library. (Does that count as recursion?) 


3 
5; And finally finally, ny own utilities. 


, 


in wini_source_qitoday_pe_utilities_asm 


The code above goes just affer the part where we pull in George's sprite code. It is not possible for a 
reusable library's routines to make any assumptions about the use of registers outside of the library 
itself. 


To this end, each of the following routines will preserve any register that it uses, with the exception of 
registers that are documented to return a potentially useful value. Create a new file with the name 
given above, in my case — yours may be different, and add the following routines to it. 


The first subroutine is W_INPUT which allows an information window fo be used to accept input from 
the user It works by calling the WMAN routine that sets the channel ID to the information window in 
question, then copies the current value of the string to be edited to a working buffer. A jump back into 
WMAN is made to allow the user to edit the string. The edit may be terminated by ENTER, ESC, Up 
arrow or Down arrow. 


Note: 

The QPTR documentalion states that DO will be zero if ENTER was pressed, negative for any errors, 
and positive if ESC, Up or Down were used to terminate the edit. This is not frue as there is no code in 
WMAN that does this. DO will always be zero at the end of an edit, unless any errors occurred. In order 
to be consistent with the documentation, the library routine iw_input correctly sets DO to a positive 
value — actually 1 - when ESC, Up or Down arrow terminates the edit. 


This file contains useful utilities for a Pointer Environment 
application. It's just crying out to become a library! ;-) 


IW PRINT - Print a string to a designated information window. 
CP_STRING — Copy a string between two locations. 
AP_STRING — Append one string to the end of another. 


; 
H 
H 
3 IW_INPUT -- Get input from a designated information window. 
j 
3 
3 


IW_INPUT : accept input from an information window. The routine has 
a working buffer of 1024 characters maximum which is 
more than enough for any information window width. 


Entry Registers: 


D1.W Information window number. 

D2.L Ink colour, or negative ink colour. See WM_SWINF documentation. 
A2.L WMAN vector. 

A3.L Pointer to string. 

A4.L Pointer to work def. 


Exit Registers: 


D1.W Terminating character: Enter, Esc, Up arrow, Down arrow. 

D2.L Preserved. 

A1.L Buffer pointer. 

A2.L Preserved. 

A3.L Buffer pointer. 
L Preserved. 


AA. 


Errors: 


DO = negative: Any I/O error. Old string at (A3) unaffected. 

DO = zero: Enter terminated the edit. Old string at (A3) updated. 

DO = Positive: Up, Down or ESC terminated the edit. Old string at (A3) 
updated, unless ESC pressed. 


p BS SS SESS SSeS SSeS See sse SSS SSS SS SS SS SSS SS SSeS SSS sss Sse esessscssssss 


iw_input movem.1 a2-a3,~—(a7) Save WMAN vector & source buffer. 
iw_copy lea iw_buffer,a2 Copy destination buffer. 

bsr cp_string Copy to work buffer. 

move.1 (a7) ,a2 Get WMAN vector. 

jsr wn_swinf(a2) Set channel to info window. 

bne.s iw_exit Bale out on error. 

lea iw_buffer,al Edit buffer required in Al. 

jsr wm_ename(a2) Edit string in info window. 

blt.s iw_exit Negative is an error. 


Bug alert. It seems at present, that this vector always returns with 
DO set to zero or negative, but never positive. Sigh. The following 
code tries to reset that situation to how it should be, according to 
the docs. 


Nek Nee ee ee ee we 


empi.w #27,d1 ESC pressed = abort edit. 
beq-S iw_esce Yes, all done. 
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move.1 a3,a2 Original buffer is destination now. 


lea iw_buffer,a3 New string found here. 
bsr cp_string Copy new value to old buffer. 
empi.w #$0a,d1 Was ENTER pressed to end the edit? 
bne.s iw_ese No, set DO positive. 
elr.1 a0 Zero = ENTER was pressed. 
bra.s iw_exit Done. 
iw_ese moveq #1,d0 Set DO positive as required. 
iw exit movem.1 (a7)+,a2-a3 Tidy WMAN vector off stack. 
tst.1 dd Make sure Z flag is correct. 
rts 


3 


; Working buffer for IW_INPUT. A maximum of 1024 characters is allowed. 


x 
iw_buffer ds.w 51241 


The next routine is iw_print and simply prints a string to an information window. The information 
window is cleared first before printing. All the hard work is done by WMAN. 


Entry Registers: 


D1.W Information window number. 

D2.L Ink colour or negative ink colour. See WM.SWINF documentation. 
A2.L WMAN vector. 

A3.L Pointer to string to be printed. 

A4.L Pointer to window working definition. 


Exit Registers: 


All registers are preserved except D0. 


Errors: 


Any I/0 error. 


iw_print movem.1 d1—d3/a0—al/a3,—-{a7) Save working registers. 


jsr wm_swinf(a2) Set channel to info window. 
bne.s iwp_exit Bale out on error. 

iwp_cls moveq #$20,d0 cis. 
moveq #1,d3 Timeout. 
trap #3 Do it. 

iwp_prnt moveq #io_sstrg,d0 Send a string of bytes. 
move.w (a3)+,d2 Byte count. 
beq.s iwp_exit Nothing to do. 
moveq #-1,d3 Timeout. 
exg a3,al Pointer in Al is needed. 
trap #3 

iwp_exit movem.1 (a7)+,d1-d3/a0-al/a3 Restore working registers. 
tst.1 dO 
rts 


——S 


The subyoutine cp_string copies a string from a location pointed to by A3 to the location pointed to 
by A2. The two locations must be holding a QDOS formatted string with the word count at the 
beginning and the bytes immediately following. 


The code below copies byte by byte so it best suited to fairly small strings and no checks are carried 
out to see if the strings overlap in memory, which could lead to corruption after the copy has 
completed. However it is unlikely for this to actually happen when copying strings around. 


3; CP_STRING : Copy a eieing: from a buffer at A3.L to a buffer at A2.L. 
4 The word length is always copied, even if zero. 
; NOTE: No checks are done to prevent overlapping! 


; Entry Registers: 


; A3.L Source buffer address. 


a 
, 
; A2.L Destination buffer address. 
oa 
» 
, 


5; Exit Registers: 


5; All registers, except DO, are preserved. 


> 
’ 
3 Errors: 
2 
, 


; None. DO is zero on exit. 


eo! string 
movem.1 a2~a3,—(a’7) Save the workers. 
move.w (a3)+,d0 Get the source length. 
move.w d0,(a2)+ Copy to output buffer. 
beq.s cs_exit Nothing more to do. 


bra.s cs_next 


es_loop move.b (a3)+,(a2)+ Copy one byte. 
es_next dbf d0,cs_loop And all the rest. 
es_exit movem.1 (a7)+,a2-a3 Restore the workers. 
elr.1 dO No errors. 
rts 


And finally, for now at least, the ap_string routine appends the string at A3 to the end of the string at 
A2. 


It is the responsibility of the programmer to ensure that enough space exists at the end of the 
destination string to hold the string being appended. The routine cannot check for this and assumes 
all will be well. 


If your buffer is too small, there is a good chance that whatever follows the buffer will be corrupted. 
You have been warned! 


3 AP_LSTRING : Append one string to another. The destination buffer is 
Fi assumed to be big enough for both strings. This code 
5 cannot check for this. 


5 Entry Registers: 


3 A3.L String to be added to A2. 


ed 
Es 
> A2.L Destination string address. 
3 
, 


Exit Resisters: 


All registers, except DO, are preserved. 


Errors: 


None. DO is zero on exit 


Nee Nee ee ee ee ee ee ee 


ap_string 
movem.1 di/a2—a3,—(a7) 
move.w (a3)+,d0 
beq.s as_exit 


move.w (a2),d1 
add.w d0,(a2)+ 
adda.w di,a2 
bra.s as_next 


move.b (a3)+,(a2)+ 
dbf d0,as_loop 


as_loop 
as_next 


movem.1 (a7)+,d1/a2—a3 
elr.1 d0 
rts 


as_exit 


For now, those are all you need. 


Save working registers. 
Get second string size. 
Nothing to do, bale out. 


Current length of destination. 
Store the new length. 
End of destination string. 


Append one byte. 
And all the rest. 


Restore working registers. 
No errors. 


Now when you assemble to main file, it will hopefully assemble without errors and you will be able to 
run the program. 

Once you type in a filename which is longer than 7 characters, you will hopefully see it transferred to 
the library and binary filenames but each with a separate extension. 


Under normal circumstances, these defaults will be correct, but you will be given the opportunity to 
change them when the symbol file has been loaded. 


In order to load the symbol file, you hit the Load" loose item, or press ‘O’, but at the moment, this 
loose item is not yet wired in, so does nothing. If you have a slow QL, you might see fhe status 
change from available to selected and back to available again. 


Pressing the TAB key forces the pointer to jump into the application window, and pressing ESC exits 
the program. 


Hopefully it will look remarkably similar to the following screen shot. 


Sum file frami_libtest_sym_Ist 
Lag ie fPamt_libtest_lib 
a fsete fromi_libtest_bin 


We have now almost completed step 3. It is now time to complete step 3 and move on to step 4. 
Change the code for the “Sym file” loose item’s hit routine to the following. 


3 
3; SYM FILE loose item action routine. 


J 
afun0_2 movem.1 d5-d7/a0-a4,—-(a7) Preserve important registers. 


bsr.s li_unav Make LI status unavailable. 

bsr symhit Do it all. 

movem.1 (a7)+,d5-d7/a0-a4 Restore important registers. 
empi.w #27,d1 Did we abort the edit? 

beq li_reset Yes, bale out. 

bsr.s li_avail Make LI status available, if all ok. 
bra li_reset Make Sym file available. 


The changes are quite simple. We call out fo a subroutine - fiunav - to change the status for all 
loose items from ‘Lib file’ onwards to become unavailable. As we are potentially changing the symbol 
file name in this action routine, we cannot allow incorrect data to be used by the Library and Binary file 
names. 


After returning from the main sym_hit code, we check to see if the user aborted the edit with the ESC 
key. If so, then we know that the symbol file name currently on display is potentially garbage, and we 
exit leaving only the “Sym file” loose item available. 


If the user successfully entered a symbol file name and did not abort the edit, we call the routine at 
li_avail to set ail the loose items, except "Save" to available. Save’ will be enabled by the actions of 
the ‘Load’ loose item later. 


Reset all Loose Items, affected by hitting "Sym file" to unavailable 
which is only possible, using the following code, because the 4 
bytes affected are consecutive. 
itunav move.1 #$11111111,ws_litem+1i_libfile(a1) 

bra.s li_rdrw Redraw selected loose items. 


li_avail move.1 #$01011101,ws_litem_1i_libfile(a1) 


li.rdrw moveq #-1,d3 Request selective redraw. 
jsr wm_ldraw(a2) Redraw selected loose items. 
rts 


The above code is all that is required to enable and disable the affected loose items. It is quite 
simple to do this as there are only 4 loose items affected and the status bytes for those four are 
consecutive in the status area. Also, for efficiency, we set all 4 as desired, and make one single call to 
wm_Idraw rather than one call per loose item. 


Note: 
You may remember that | mentioned, way back at the start, that there was more than one way to set 
the status bytes for these 4 loose items? Well, the code above is the other way. 


You may now assemble and run the application, HIT "Sym file’ and type something in. 


If you abort the edit with ESC then the loose items remain disabled. If you press ENTER (or up/down 
arrows) then the loose items are enabled. "Save" remains disabled at all times. 


Handling the Lib File Loose Item 

There's not much happens when the user HITs the ‘Lib file’ loose item. The user is allowed to change 
the default name, chosen for the library file, from that defaulted by LibGen. The defaults for this option 
and the binary file are based on the original symbol {ile which itself is based on the original source file 
name. 


For example, if you assemble a source file named raml_libfest_asm, you will get a generated binary file 
of ramt_libtest_bin, a listing of the code in ramt_libtest_Ist and a symbol file of rami_libtest_sym. 


Using George's sym_bin utility, you convert ram1_libtest_sym into ram1_libtest_sym_st. It is this latter 
file that LibGen processes for you. 


Based on the name of this fatter file, LibGen chooses rami_libtest_lib for the library file - the one 
containing an ‘IN’ and a ‘BIN instruction, and for the actual binary file making up the library, chooses 
ram1_libtest_bin. 


In most cases, these defaults will be fine, but at least LibGen gives you the ability to change them as 
desired. 


After all, it's not wise to keep your various library files on rami. is if! 


The code for the ‘Lib file” hit routine is as follows. This replaces the existing dummy code already in 
the main source file. 


3 
; LIB FILE loose item action routine. 


; 
afun0_3  movem.1 d5-d7/a0-a4,—-(a7) Preserve important registers. 


bsr lib_hit Do it all. 
movem.1 (a7)+,d5-d7/a0—-a4 Restore important registers. 
bra li_reset Make Lib file available. 


As before, | tend to prefer the actual hit routine to be small. The above code simply preserves the 
desired registers, calls out to the lib_hit code, then restores the registers and exits resetting the "Lib 
file" loose item to available. You will see that it remains in a selected state until you complete the edit. 


3 
3 This code carries out all the nasty work for a hit on the Lib file 
3 loose item. It is called from afun0_3 above. 
j See Ss 
lib_hit moveq #iw_libfile,d1 Info window number in dl.w. 
lea lib_buffer,a3 Current lib file buffer. 
moveq #1,d2 Blue Ink when editing. 
bsr iw_input Get input from desired info window. 
blit.s 1lf_exit Something went wrong, bale out. 


Nothing much of interest here, the processing is almost identical to that we have seen already for 
allowing the user the ability to type a symbol file name. 


We don't have to check for the ESC key terminaling the edit because we always, unless there was an 
error, exit via the tidy up code at If_ok. 


Remember that our library routine iw_input copies the data from the working edit buffer back to the 
correct location on a successful edit. 


Print the lib file name. We do this at the end of a normal edit and 
when the user aborts with ESC. This keeps the info window tidy. 


f_ok moveq #iw_libfile,d2 Information window desired. 
moveq #0,d2 Black ink. 
lea lib_buffer, a3 Filename to print. 
bsr iw_print Print it. 

lf_exit rts 


The code above, you may notice, doesn’ preserve the terminating character in Di. There isn't really 
any requirement to do so in the handling of a ‘Lib file” HIT 


Handling the Bin File Loose Item 
The code for handling a hit on the “Bin file” loose item is almost identical to the above. It will 
be shown here without further discussion. 


3 
3 BIN FILE loose item action routine. 


r 
afun0_6 movem.1 d5-d7/a0-a4,—-(a7) Preserve important registers. 


bsr bin_hit Do it all. 
movem.1 (a7)+,@5-d7/a0—a4 Restore important registers. 
bra li_reset Make Bin file available. 


a 
3; This code carries out all the nasty work for a hit on the Bin file 
3 loose item. It is called from afun0_6 above. 
? 
bin_hit moveq #iw_binfile, d1 Info window number in dl.w. 
lea bin_buffer,a3 Current bin file buffer. 
moveq #1,d2 Blue ink when editing. 
bsr iw_input Get input from desired info window. 
blt.s bf_exit Something went wrong, bale out. 


j 
; Print the bin file name. We do this at the end of a normal edit and 
3 when the user aborts with FSC. This keeps the info window tidy. 


- 
bf_ok moveq #iw_binfile, d1 Information window desired. 


moveq #0,d2 Black ink. 
lea bin_buffer, a3 Filename to print. 
bsr iw_print Print it. 

bf_exit rts 


lf you assemble the code and execute it you should find that everything works as desired. 


End Of Chapter 32 

So, that’s the end of the second exciting instalment of LibGen. Next time, we will add the real meat of 
the utility - the ability to load a file, select which entries you want from a menu, and then save those 
entries out to a file suitable for inclusion in future assembly programs. 


[2C (nteriace tor QL Emulators 
Part © 


by fam Buritiasinany 
| recently purchased some PCF8574A's and found the price 


was now fairly high at £4.68 plus VAT each from Farnell and £1.63 plus VAT at RS Components. So | 
looked to see if there were any other devices about, and came across a device from Microchip of PIC 
fame. Called MCP23017 (Farnell part number 1332088} at 95p plus VAT or from RS Components (part 
number 403-806) for 78p plus VAT. Please be aware there may be a minimum order from these 
companies, so it is worth checking out other suppliers. It is even better value than the PCF devices as 
it has 2 * 8 bit ports, so 16 GPI (general purpose interface) lines, which otherwise would need 2 of the 
PCF devices - a major saving either way. 


bse MCP23017 full circuit 
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As you can see the circuit is straightforward, the main difference, apart from the 16 I/O's is the reset 
pin (18) — this must be held high. As you may have seen in the address table in the part 5 of this series, 
the MCP23017 has the same address range as the PCF8574, so 8 of these device can be used on 
each I2C bus giving a maximum of 128 I/O lines. Put another way, itis the same as using 8 * PCF8574 
and 8 * PCF8574A with a lot less wiring to do. 


Another major hardware difference is the way the outputs work. With both the PCF8574 and 
PCF8574A, when in output mode, the output is what is called sink only. That is, there is, in effect, a 
transistor between the output pin and the GND, with a weak resistor from the output pin to the 5V 
supply rail, which is why when a given pin is given a ‘high, it is in fact low. Or put another way, it is 
inverted. This is one of the reasons, | put a driver chip ULN2803 to drive the LED's on my test card 
(see part { of this series) to make the LED's display in the correct sense. In the case of the MCP23017, 
it has a more normal TTL type output. Sometimes referred to as a totem pole output. 


supply rail supply rail 


When "1" siqnaled 
this transistor is an 
output goes high 


QuTSIDE Ic 


output autput 
When "1" signaled 
this transistor is on When "@" signaled 
output goes law this transistor is on 
Gnd outpul goes Law Gnd 
Only way ta drive LED is Current sink can be either way 
from the supply rail ta the output 
PCF8574(A) Output arrangement MCP23017 Oulput arrangement 


This is diagrammatic, this is not how it is really done within the chip, This is just for explanation. 


There are, in effect, two transistors, one from the output pin to GND, as in the PCF example, but the 
resistor in the PCF is now replaced with another transistor One transistor is turned on at a time. The 
output can sink from supply to GND or to +5. For example you can connect LED's from the output 
pin (LED anode), to GND (LED cathode) via a current limiting resistor with no extra chip io invert the 
sense. Another cost saving. However, you should not draw more than 20mA from any pin. If you need 
more current then you will still need something like the ULN2803 chip or drive power transistors. | shall 
leave this to you since it will depend on your application. In addition the BV4221 can only provide up to 
a maximum of 100mA. If your application requires more current, then you will have to provide an 
external power supply. 
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The piciure above is my test circuit with two MCP23017 IC sockets with a BV4221 


Now the software side of things 

The MCP23017 has 22 registers, do please look at the datasheet for the functionality of these 
registers. However | shall show in the following routines how to toggle the outputs for both "A" and "B’ 
ports. The important thing to bear in mind is you have to send the start signal, then the device 
address, then the register address, the value for that register and finally the stop signal. So for 
example to set the "A® port to output mode we send “s-40 00 00 p”. Then we can send "s—40 14 ff p’, 
this will then set all the outputs on port “A” high. 40 is the address ‘in hex” of the device if all the 
address links are in place, ie. all the address pin are low. Also note all hex letters must be lower case. 


| shall not repeat the common routines you need to make all this work. See QLT Vol 16 issue 1. You 
need lines 1000 to 3090 from this listing. 


Until next time, when | will be looking at a RS232 fo 12C converter you can used with a ‘Black Box’ QL. 
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Glossary of Abbreviations anal Terms 
6-P to Q By iy fom 


PAL Programmable Array Logic, a type of logic chip, also 


used for Phase Alternate Line - most of the world uses this television broadcast 
encoding system 


Pandora Name given to a case system made by members of the NEMQLUG (North East 
Manchester) QL user group. This case was specially made to allow you to fit a QL 
or Aurora circuit board into a neat and portable metal black case. 

PAR An abbreviation used to represent a parallel printer port, sometimes known as a 


Centronics compatible printer port. On an original QL, you'd tell programs to print 
to SERI or SER2. If you use the printer port on a Super Gold Card, or on a PC 
fitted with a QXL or QPC emulator, it will usually have the name PAR as far as ihe 
QL system is concerned, so you'd tell programs to print to PAR instead of SER1, for 
example. A parallel port differs from a serial port in that it can send several bits of 
intormation down a cable at the same fime (usually 8) rather than 1 at a time as 


Parameters 


Parser 


would be the case with a serial port. Printing via a parallel port would usually be 
faster than fo a serial port, but the disadvantages could be that {a) cables have to 
be shorter than serial links for reliability, and (b) information can usually only go out 
from the computer to whatever is connected, you cannot get much information 
back, so you couldn't connect two computers together to share information via the 
parallel port on a Super Gold Card, for example. 


Values passed to a procedure or function. For example, a function which adds two 
numbers together would have two parameters, one for each of the two numbers 
to be added together For example, DEF FN Add(numberi.number2) would be called 
using two numbers in place of the names ‘numberl” and ‘number2°: LET 
resull=Add(2,3) 


A part of a compiler or other program (e.g. a program which runs a text adventure 
game) which processes the text to extract information. This checks that the 
syntax of the text is correct and as it should be for the application. For example, 
the Turbo compiler parses a SuperBASIC or SBASIC program to ensure that the 
text of the program is correct before it tries to compile the program. 


Pass by value or reference Refers to the method by which parameters are passed to a 


PCB 


PCL 


PD 
PE 


PIPE 


Pixel 


PNG 


procedure or function. In effect, it refers to whether or not the value of the variable 
passed to the routine is changed upon return from the routine. In effect, ‘pass by 
value’ means that a copy of the value is passed to the routine and even if you try 
to change its value within the procedure or function, the original value is restored 
when you exit. ‘Pass by reference’ means that if you change the value of the 
variable within the routine. that affects the variable itself, not the copy, so the 
change remains when you exit from the routine. 


Printed Circuit Board, electronic boards where components are placed to make 
circuits, normally manufactured 


Printer Control Language. a Hewlett Packard system for controling printers. There 
are various levels of this, up to level 5, and commonly used with laser printers. Also 
used to some degree by Deskjet and similar inkjet printers 


Public Domain 


Abbreviation for Pointer Environment. See PTR_GEN. PE normally refers to just the 
facilities provided by PTR_GEN alone, whereas the term Extended Environment 
(EE) refers to the combined facilities of the files PTR-GEN, WMAN and HOT_REXT. 


A kind of conduit used to send data from one place to another on the QL. 
analogous to a pipe used to carry water from one place to another, for example. 


A Picture ELement, one dot of a screen picture or graphic. Pictures are generally 
referred to as having so many pixels across and so many down. A mode 4 screen 
from an original Sinclair QL would have 512 pixels across and 256 pixels down, 
making a total of 131,072 pixels on the screen. 


The letters stand for Portable Network Graphics. This is a graphics compression 
system created in the 1990s. 


Pointer Environment see PE above. 


Port 


1. to rewrite a program to work ona different processor or operating system, or 2. 
an electrically wired 1/O system in a processor used for communication between 
the processor and other devices or other computers. 


Procedure 


Proforma 


Program 


PROGS 


ProWeSS 


PSU 
PTR_GEN 


Q+4 


Q-emuLator 


Q40, Q60 


QDOS 


QDOS CLASSIC 


QeM 
QJUMP 


A block of code, usually given a name, which is used to perform one or more 
specific tasks within a program. Think of it as a building block for a program. Ii can 
be called from other places in a program several times by different parts of a 
program, to avoid having to rewrite the same code over and over again. Unlike a 
function (qv) a procedure does not return a value upon terminating. 


Name of software from PROGS (qv) which provided a system whereby other 
specially written software could create Vecior Text (qv) and Vector Graphics. 


We tend fo use the word Program without thinking about how to define it. In 
simple terms, it is a set of instructions for a computer to perform a specific task. 


Belgian software house run by Joachim van Der Auwera. Produced a wide range 
of QL software such as The Painter, Line Design, Proforma and ProWeSS. 


The PROGS Windowing sub-system. Advanced Window Manager software from 
QL software house PROGS. 


Power Supply Unit 


The pointer interface for the QL’s windowing system. The file PTR_GEN (or its 
equivalent in SMSQ/E) is responsible for controlling a mouse pointer on the screen 
and for saving and restoring the contents of program windows as you switch 
between programs with CTRL-C (see above). PTR_GEN is supplied with most 
pointer environment programs, such as QPAC2. 


A large QL expansion unit sold by CST in the 1980s. It allowed up to four expan- 
sion cards fo be added to the QL at a time. It consisted of a large metal base unit 
on which the QL stood and into which up to 4 cards could be plugged. It then had 
a short ribbon cable which connected the base unit with a small circuit board 
which plugged into the QL’s expansion socket. The Q+4 is now a very rare 
device. 


A QL emulator program written by Daniele Terdina. There are versions for Win- 
dows, Mac and OSX operating systems, allowing you to run QL software on those 
systems. 


Two computers designed by Peter Graf in Germany. These computers can use 
either the SMSQ/E or QDOS Classic operating systems. They feature displays up 
to 1024x512 pixels in size and use 16 bit colour 


QL Drive Operating System or QL Disk Operating System. This is the operating 
system of the QL, which is basically what makes it tick. QDOS is responsible for 
starting up the QL when you switch it on, and provides the necessary code and 
routines to let you do anything from printing to the screen to multi-tasking your 
programs. Tony Tebby (its designer) has also been known to refer to QDOS as 
Domes-DOS. 


Name of a version of the QL operating system which runs on (a) the Amiga QL 
emulators and (b) the Q40 and Q60 


A little known emulator of the QL in software on Atari computers. 


A QL company set up by Tony Tebby after he finished working for Sinclair Tony 
Tebby designed the QL’s operating system and went on to produce major 
software for the QL such as QRAM and QPAC2. The name lives on in terminology 
such as ‘Qjump Standard Configuration Block” (a software system allowing for 
standardised configuration of QL software). 


QLIB 
QL Today 


QL User 


QL World 


QLAY 


QL2K © 
QLSSS 
QMenu 
QPAC 


QPC 


QPTR 


QRAM 


QSAVE 
QTYP 
QUANTA 


QUBIDE 
QVME 


QXL 


Abbreviation used for the Q-Liberator BASIC compiler from Liberation Software. 


A magazine about the QL, first produced in 1996. The magazine is published in 
Germany by Jochen Merz Software. 


A QL magazine from the 1980s. Eventually merged with another magazine called 
QL World. 


A QL magazine first published in the 1980s. For many years it was the main QL 
magazine, and ownership changed many times until the magazine was finally 
closed by publishers Arcwind. 


A freeware QL emulator program for Windows 95, DOS and Linux based systems. 
Allows these machines to run QL software, and can be downloaded free from the 
Web site http://www.inter.nLnet/hec/A.Jaw.Venema 


A further development of the Qlay QL emulator by Jimmy Montesinos 
See SSS 
See Menu Extension above. 


QL Pointer Accessories. Either of two packages produced by Tony Tebby to 
enhance what you can do with your QL. QPAC gave you a number of small but 
useful programs such as a calculator and typewriter and alarm clock, while QPAC2 
gives you a file handling menu, buttons and all sorts of utilities to help you with the 
multi-tasking and windowing system on the QL 


QL on PC, a commercial program which allows a PC to run QL software by making 
the PC pretend to be a QL as far as the software is concerned. 


People often use this term to mean the Pointer Environment or Extended Environ- 
ment. However, QPTR is actually the name for a programming toolkit for the poin- 
ter environment by Tony Tebby and his old company Qjump. It consisted of a huge 
manual, plus a floppy disk which had the qptr toolkit and various example files. 


Predecessor to QPAC2, a collection of menus and utilities vaguely along the lines 
of QPAC2. QRAM is no longer available 


See SAV below. 
QL Typing checker, from Tony Tebby 


The main QL user group, originally set up in 1984, when it was originally called 
IQLUG (the Independent QL Users Group). After deciding that the name IQLUG 
wasn't liked by everyone {some found it hard to pronounce) the group's name was 
changed to QUANTA, which was the name of the group's newsletter After a while, 
someone came up with a slightly contrived ‘QL Users And Tinkerers Association’ 
as a proposed meaning for the acronym QUANTA. It stuck. 


A hard disk interface for the QL. 


A gtaphics card available for the Atari ST QL emulator VME stands for Versa 
Module Europe, enabling a card size called Eurocard to be used on 68000 based 
computer systems such as Ataris 


A card which plugs into an ISA (Industry Standard Architecture) slot on a PC, 
allowing it to run QL software much faster than an original QL. ! have no idea what 
the X stands for - probably implying extended QL or something like that. 


Although the postage situation for next year is not looking 
good for us, we have to find a solution somehow. There is a 
possibility that the next issue will be shipped from Austria ... 
but there is no solution for the summer issue yet. 

Apart from this, this year’s QL Today issues were very 
enjoyable - thanks to you, authors and subscribers! Loads of 
material - very interesting stuff, many more “hardware” 
articles than I ever expected... I am glad the QL scene is still 
as active and alive as it is and I really look forward to see 
some/many(?) of you in Hamburg next year! 


FROM TH 
QL TODAY 
TEAM 


Very good News - QL Show in Germany in 2013 - in Hamburg! 
We need your vote fo find the best date! 
It seems that the article in the last issue, of QL Today has triggered something for next year. 


The venue this time will be Hamburg ... a nice city and worth visiting, if you have not been there before. 
And if you have, worth another visit too.. as the address will be "Reeperbahn 1° (famous!) - the entry to 
St. Pauli 


Rainer Woikwitz offered conference rooms for the meeting for up to 200 people in den “Tanzende 
Tiirmen'/STRABAG. ... and he says it will have a beautiful view over Hamburg and its port (only 10 
minutes walking distance from there). The towers ate quite interesting to look at, especially if you stay 
in front of them, You can search the web for “Tanzende Tiirme” to get some impressions about the 
intersting building. 


We thought that the date for the meeting should avoid the holiday season and major events in 
Hamburg, to increase chances for reasonable hotel rates. 


We found that the following dates are probably the best ones, chances for good weather, chances for 
less traffic, chances for affordable hotels: 


a) Weekend 18th/19th of May 

b) Weekend 25th/26th of May 

c) Weekend 1st/2nd of June 

d) Weekend 3ist of August/Ist of September 


So, we should start working out which date suites most of you best, and if you prefer the Saturday or 
the Sunday to be the “meeting” date. 


Assuming, that a visit to Hamburg will not just be for a QL meeting.other activities like siteseeing or 
shopping can easily be placed around the meeting. A note for visitors from outside Germany: shops 
are closed on Sunday, but there are loads of other things to do, eg. like visiting the harbour and 
various ships, or cruise through the harbour, musicals, Zoo Hagenbeck, all sorts of museums or the 
famous Miniatur Wunderland (the world’s largest miniature train exhibition). 


Please let us know if there is any interest, and what would be your preferred date and day ... please 
send an email to SMSQ@J-M-S.com, subject “QL2013" and the letters for your TWO preferred dates 
(ab.c.d) and whether you prefer Saturday or Sunday, or no preference. 


Also, help would be most welcome - Rainer said he does not have too much time to care for other 
things like hotels. He can provide technical equipment which could be required for talks or 
demonstrations (hint, hint!), like a large screen or projector and internet, of course. 


Please reply as.ap. so that we can start working on the details. For dates in May, only half a year is 
left, which is 2 issues of QL Today in between a poll of the preferred date and advertising the event. 
We may not be able to fill the room with 200 people, but after having had several meetings in the 
South, this is very North and a chance to meel people we have not seen for many years! 


4 And - Hamburg is worth visiting and seeing. anyway! 


